feat: brownfield CLI #176

artus9033 · 2026-01-09T15:27:31Z

Summary

This PR addresses a few important aspects:

Make brownfield a fully-standalone library - currently, packaging artifacts is easy with Rock, but complex without it. The aim of this PR is to give brownfield a standalone, batteries-included tooling to do so.

introduces a standalone CLI for the brownfield plugin to ease usage without Rock
adds proper documentation sections

The new CI builds artifacts from the RN app using the CLI and then builds the iOS & Android consumer apps using these artifacts.

Changes in this PR depend on callstackincubator/rock#666 being merged & published.

Test plan

CI green.

…ie folder as output base

thymikee · 2026-01-12T12:18:21Z

.eslintrc.json

 {
  "root": true,
-  "extends": ["@react-native", "prettier"],
+  "extends": ["prettier"],


Yes, intended - otherwise CLI gets warnings due to lack of React. I'll rework the ESLint config in a separate PR anyway.

thymikee · 2026-01-12T12:19:50Z

CONTRIBUTING.md

 - `gradle-plugin:lint` - runs linting on the Brownfield Gradle plugin source code
 - `typecheck` - runs TypeScript type checking on all TS source files in the monorepo *[Turbo]* 
 - `build` - runs all `build*` tasks in the Turbo repo - see below for more details *[Turbo]* 
+- `build:watch` - runs all `build:watch` tasks in all workspaces


I do with just watch or dev

thymikee · 2026-01-12T12:25:09Z

docs/docs/docs/cli/brownie.mdx

@@ -0,0 +1,133 @@
+# Usage with Brownie package


I think this shouldn't be a part of this PR?

thymikee · 2026-01-12T12:27:32Z

docs/docs/docs/cli/introduction.mdx

+React Native Brownfield comes with a batteries-included, all-in-one CLI tool called `brownie` that helps you build and publish your React Native app as a framework artifact for iOS (XCFramework) and Android (AAR).
+Additionally, it contains CLI utilities for other tools like the `@callstack/brownie` state management tool.
+
+> ![NOTE]
+> The `brownie` CLI is a unified tool serving both the needs of `@callstack/react-native-brownfield` and `@callstack/brownie` packages. The name `brownie` does not mean it is only meant for `@callstack/brownie` state management tool; it is the main CLI for React Native Brownfield as well.
+> Technically, the CLI itself is encapsulated in the `@callstack/brownie-cli` package, which is a dependency of both `@callstack/react-native-brownfield` and `@callstack/brownie`. Therefore, installing either of the packages will bring the `brownie` CLI tool to your project.


this is quite confusing that we need tell users that brownie is both CLI and a storage library :|

thymikee · 2026-01-12T12:29:17Z

packages/brownie/package.json

    "typecheck": "tsc --noEmit",
-    "build": "bob build && tsc -p scripts/tsconfig.json",
+    "build": "bob build",
+    "build:watch": "nodemon --watch src --ext js,ts,json --exec \"bob build\"",


nit: you could run tsc --watch with watch flag (what we do in Rock)

thymikee · 2026-01-12T12:40:37Z

packages/cli/.release-it.json

@@ -0,0 +1,18 @@
+{


this was removed in favor of change sets. I think you need a rebase

thymikee · 2026-01-12T12:41:03Z

packages/cli/package.json

+  "name": "@callstack/brownie-cli",
+  "version": "1.0.0",
+  "license": "MIT",
+  "author": "Michal Chudziak <[email protected]>",


update author

thymikee · 2026-01-12T12:41:26Z

packages/cli/src/brownfield/commands/index.ts

+export * from './packageAndroid.js';
+export * from './packageIos.js';
+export * from './publishAndroid.js';


avoid barrel exports please, use explicit ones

thymikee · 2026-01-12T12:44:11Z

packages/cli/src/brownfield/commands/packageIos.ts

+        // below: the userConfig.reactNativeVersion may be a non-semver-format string,
+        // e.g. '0.82' (note the missing patch component),
+        // therefore we resolve it manually from RN's package.json using Rock's utils
+        reactNativeVersion: getReactNativeVersion(projectRoot),


I think it should be fine to pass 0.82 instead of 0.82.0

thymikee · 2026-01-12T12:45:30Z

packages/cli/src/brownfield/commands/packageIos.ts

+        // e.g. '0.82' (note the missing patch component),
+        // therefore we resolve it manually from RN's package.json using Rock's utils
+        reactNativeVersion: getReactNativeVersion(projectRoot),
+        usePrebuiltRNCore: 0, // for brownfield, it is required to build RN from source


uh oh, this should be a boolean, not a number! we should fix that in Rock

callstackincubator/rock#670

thymikee

Let's rename the CLI to brownfield and not couple it with Brownie. Needs a rebase, otherwise it looks good!

artus9033 added 5 commits January 7, 2026 19:30

chore: squashed rework of repo

72d2d96

ci: consolidate per-platform jobs to reduce cache entry count

d8b1dfe

feat: brownfield CLI

000e9ef

chore: add missing dependencies

2b833a1

chore: add build:watch script

0d3ab19

artus9033 mentioned this pull request Jan 9, 2026

feat: expose brownfield plugin actions & types callstackincubator/rock#666

Merged

artus9033 added 22 commits January 9, 2026 20:59

feat: android CLI

9032ffa

feat: iOS CLI

7a6764e

ci: update CI to use the new iOS CLI

71a2aa8

chore: update Podfile for RNApp

ece6f68

chore: move CLI files to new package

d39ddea

chore: config files for new packages

cd85740

chore: react-native-brownfield package to depend on the CLI

c7a723e

chore: update CONTRIBUTING.md

174b585

fix: problems with imports and scripts

1365628

docs: add CLI docs

c7733f3

Merge branch 'main' into feat/cli

23f3cb9

ci: adjust paths to CLI

0081a93

fix: iOS build error from brownie PR

a5750e1

fix: linting

c53583a

feat: unified CLI

6eae08c

ci: use brownie CLI in CI

22cca6a

feat: adjust to new Rock API

3513646

docs: add CLI documentation

fbb2a2e

fix: make Rock iOS packaging logic work in non-Rock projects

80ccb79

chore: depend on production rock packages

ee88f55

fix: brownie CLI iOS - pass packageDir to Rock helpers and use .brown…

7f96502

…ie folder as output base

Merge branch 'main' into feat/cli

a9ff914

thymikee reviewed Jan 12, 2026

View reviewed changes

chore: bump up Rock to 0.12.5

7d8f023

artus9033 force-pushed the feat/cli branch from fbff43b to 7d8f023 Compare January 12, 2026 12:20

thymikee reviewed Jan 12, 2026

View reviewed changes

docs/docs/docs/cli/brownie.mdx

@@ -0,0 +1,133 @@

# Usage with Brownie package

Copy link

Member

thymikee Jan 12, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think this shouldn't be a part of this PR?

thymikee reviewed Jan 12, 2026

View reviewed changes

packages/cli/.release-it.json

@@ -0,0 +1,18 @@

{

Copy link

Member

thymikee Jan 12, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this was removed in favor of change sets. I think you need a rebase

thymikee reviewed Jan 12, 2026

View reviewed changes

thymikee requested changes Jan 12, 2026

View reviewed changes

feat: brownfield CLI #176

Are you sure you want to change the base?

feat: brownfield CLI #176

Conversation

artus9033 commented Jan 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Test plan

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

thymikee left a comment

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

artus9033 commented Jan 9, 2026 •

edited

Loading